Reports
This section describes the reports that the Public Transport program produces. You select reports using a variety of control statements. The program writes the reports to the main CUBE Voyager print file unless otherwise stated.
The program can produce the following reports:
-
Transit line summary (including passenger hours and distance if loads are present)
-
Transfers between modes (transit and nontransit)
The REREPORT control statement produces a series of basic reports that let you examine and understand the network-simplification and route-enumeration processes. See Network simplification for examples of these reports.
You can produce a report of enumerated routes with the ROUTEO keyword and its subkeywords, REPORTI and REPORTJ. The program writes the report to the file specified by REPORTO.
Sample enumerated-route report
REnum Route(s) from Origin 1 to Destination 9 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 812 -> 9 lines PLB129A Cost=16.649 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 796 -> 796 lines PLB1-113A PLB129A 796 -> 799 -> 799 lines GMB1-39MB PLB144B PLB129A 799 -> 812 -> 9 lines PLB129A Cost=19.896 1 -> 773 773 -> 771 -> 771 lines GMB1-36A 771 -> 799 -> 799 lines GMB1-39MB 799 -> 812 -> 9 lines PLB129A Cost=17.364 1 -> 2052 2052 -> 2058 -> 806 lines ISL-UP 806 -> 812 -> 9 lines PLB129A Cost=19.896 1 -> 773 773 -> 764 -> 764 lines GMB1-24MB 764 -> 806 -> 806 lines PLB127B PLB129A 806 -> 812 -> 9 lines PLB129A Cost=20.737 1 -> 773 773 -> 764 -> 764 lines GMB1-24MB 764 -> 812 -> 9 lines PLB129A Cost=19.737
This example shows routes from zone 1 to zone 9. The first line for each route shows the access leg from the origin zone to the first boarding point. Subsequent lines for a route show pairs of transit and nontransit legs with the names of the transit lines running on the transit legs. The shown cost is used for selecting potential routes; it is not the cost used for evaluating routes.
The program will discard some of these routes for various reasons, such as a probability of use less than a user-specified minimum, or alighting and reboarding the same line. The Evaluated Routes report lists routes that are actually used between the zones.
In this example, the program finds five (potential) physical routes between zones 1 and 9. Some offer more than one combination of services.
You can produce a report of evaluated routes using either the ROUTEI or the ROUTEO keyword and the corresponding subkeywords REPORTI and TRACEI. The program writes the report to the file specified by REPORTO. Reports produced with REPORTI list routes taken; reports produced with TRACEI give a tabular output detailing component costs and summaries for each mode. When using multirouting, the report lists all routes used and the probability of taking each of them.
Specify the required origin zones with the REPORTI or TRACEI subkeywords and the required destination zones with the REPORTJ or TRACEJ subkeywords. Note that REPORTI requires REPORTJ, and vice-versa.
The following topics show:
Sample evaluated-route report produced with REPORTI
REval Route(s) from Origin 1 to Destination 9 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 796 -> 796 lines PLB129A 796 -> 799 -> 799 lines PLB144B 799 -> 812 -> 9 lines PLB129A Cost= 17.249 Probability=0.0848007 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 796 -> 796 lines PLB1-113A 796 -> 799 -> 799 lines GMB1-39MB 799 -> 812 -> 9 lines PLB129A Cost= 17.096 Probability=0.0468973 1 -> 773 773 -> 764 -> 764 lines GMB1-24MB 764 -> 812 -> 9 lines PLB129A Cost= 17.937 Probability=0.17571 1 -> 773 773 -> 764 -> 764 lines GMB1-24MB 764 -> 806 -> 806 lines PLB127B 806 -> 812 -> 9 lines PLB129A Cost= 19.137 Probability=0.17571 1 -> 2052 2052 -> 2058 -> 806 lines ISL-UP 806 -> 812 -> 9 lines PLB129A Cost= 19.896 Probability=0.226877 1 -> 773 773 -> 771 -> 771 lines GMB1-36A 771 -> 799 -> 799 lines GMB1-39MB 799 -> 812 -> 9 lines PLB129A Cost= 15.764 Probability=0.163768 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 796 -> 796 lines PLB1-113A 796 -> 799 -> 799 lines PLB144B 799 -> 812 -> 9 lines PLB129A Cost= 17.249 Probability=0.00468973 1 -> 773 773 -> 769 -> 769 lines GMB1-36A 769 -> 812 -> 9 lines PLB129A Cost= 14.849 Probability=0.121547
This report shows multiple routes from zone 1 to zone 9, along with their probability of use. The first line for each route shows the access leg from the origin zone to the first boarding point. Subsequent lines for the route show pairs of transit and nontransit legs with the names of the transit lines running on the transit legs.
The cost shown is the generalized cost of each route in minutes, weighted by the probability of use. This cost includes walk and in- vehicle times, and boarding and transfer penalties, but not wait time, which the program computes from the routes’ common segments for the origin-destination pair as a whole.
Sample evaluated-route report produced with TRACEI
REval Route(s) from Origin 1129 to Destination 757 N: 1129 Mode WaitA TimeA Actual B/XPen Percvd Dist Total Lines(weight) -> 5409 30 - 14.00 14.00 - 14.00 0.75 0.75 -> 4544 2 5.00 11.00 30.00 3.00 38.00 9.03 9.78 76(0.031) 79(0.016) 80(0.953) -> 4538 31 - 3.00 33.00 - 41.00 0.25 10.03 -> 4209 7 7.50 34.85 75.35 1.00 91.85 8.92 18.95 949(1.000) -> 757 30 - 16.00 91.35 - 107.85 0.10 19.05 Mode TimeA Dist IWaitA XWaitA 2 11.00 9.03 5.00 0.00 7 34.85 8.92 0.00 7.50 30 30.00 0.85 31 3.00 0.25 Probability=0.5248 N: 1129 Mode WaitA TimeA Actual B/XPen Percvd Dist Total Lines(weight) -> 5409 30 - 14.00 14.00 - 14.00 0.75 0.75 -> 4249 2 5.00 20.00 39.00 3.00 47.00 18.27 19.02 76(0.667) 79(0.333) -> 4201 31 - 1.30 40.30 - 48.30 0.11 19.13 -> 4209 7 7.50 17.70 65.50 1.00 82.00 4.53 23.66 1359(1.000) -> 757 30 - 16.00 81.50 - 98.00 0.10 23.76 Mode TimeA Dist IWaitA XWaitA 2 20.00 18.27 5.00 0.00 7 17.70 4.53 0.00 7.50 30 30.00 0.85 31 1.30 0.11 Probability=0.47521
This report shows two possible routes from 1129 to 757. For each route, the report lists:
-
Leg-by-leg information. The report contains a printed line for each leg, starting with the access leg, followed by alternating transit and nontransit legs, and ending with the egress leg. For each leg, the printed line shows destination node, mode, wait time, travel time, cumulative actual total cost, perceived boarding and transfer penalties, cumulative perceived cost, distance, cumulative distance, and transit lines used (along with probability).
-
Mode information. For each mode used, the report lists actual travel time, distance, and wait times.
-
Trip fare. If you model fares, the report includes the trip fare, in monetary units.
-
Probability of taking the route.
You can produce a report of fare matrices with the FAREMATI keyword in the REPORT control statement. The program writes the report to the main print file. The report shows the contents of the input fare matrices, specified with FILEI FAREMATI and used by fare systems defined by the FARESYSTEM control statement.
Sample fare-matrices report
FareMatrix(FMI.1.FROMTO) for FareSystem 3 (FAREZONE-FROMTO): ------------------------------------------------------------ J: I=1 FareSystem 3 Tot= 11 -- --- ---------- - ---- -- 1: 1 1 2 3 4 J: I=2 FareSystem 3 Tot= 14 -- --- ---------- - ---- -- 1: 1 1 3 4 5 J: I=3 FareSystem 3 Tot= 20 -- --- ---------- - ---- -- 1: 2 3 4 5 6 J: I=4 FareSystem 3 Tot= 20 -- --- ---------- - ---- -- 1: 3 4 5 1 7 J: I=5 FareSystem 3 Tot= 23 -- --- ---------- - ---- -- 1: 4 5 6 7 1
You can produce a report summarizing transit lines with the LINES keyword in the REPORT control statement.
Sample transit-line-summary report (with line loadings)
REPORT LINES UserClass=Total Name Mode Op Stp Cr Distance Time Pass PassDist PassHr Sort=MODE ---------------------------------------------------------------------------------- ISL-UP 1 1 14 - 13.60 13.56 28,407.36 15,403,939.52 2,557.14 ISL-DN 1 1 14 - 13.60 13.56 46,808.82 22,259,805.12 3,694.35 GMB1-29AA 7 11 3 - 2.46 6.48 1,295.35 39,401.16 15.01 GMB1-29AB 7 11 4 - 3.68 9.87 4,998.67 1,192,384.23 451.21 GMB1-53B 7 11 14 - 7.90 23.28 2.14 568.86 0.25 GMB1-55A 7 11 13 - 5.05 16.13 4,901.84 477,329.89 306.13 GMB1-49MA 7 11 5 - 2.70 8.28 16,684.93 2,308,165.02 1,202.95 GMB1-49MB 7 11 2 - 1.98 7.05 7,712.42 1,527,059.16 906.21 GMB1-24MA 7 11 10 - 6.07 17.53 31,436.51 8,892,119.27 3,785.20 GMB1-24MB 7 11 10 - 5.49 17.76 31,802.20 9,824,320.61 4,516.16 GMB1-2A 7 11 5 - 2.11 5.99 4,507.49 915,698.20 438.00 GMB1-2B 7 11 5 - 3.18 10.96 4,562.50 1,009,772.05 568.80 GMB1-16MA 7 11 4 - 8.97 20.90 5,178.26 4,630,383.81 1,797.44 GMB1-16MB 7 11 6 - 10.29 26.14 2,007.41 1,800,646.77 699.25 GMB1-1A 7 11 5 - 6.01 13.86 202.24 3,790.72 0.91 GMB1-1B 7 11 5 - 7.08 19.15 370.56 16,756.35 19.74 GMB1-39MB 7 11 7 - 8.25 22.77 21,992.27 7,540,680.36 3,531.89 GMB1-55B 7 11 12 - 4.92 12.67 2,796.67 1,090,492.38 465.26 GMB1-52A 7 11 6 - 8.79 22.07 8,460.99 4,409,590.96 1,836.13 GMB1-52B 7 11 6 - 8.79 22.07 10,497.51 6,561,755.16 2,713.20 GMB1-39MA 7 11 6 - 8.39 22.10 44,765.14 11,716,456.15 5,232.96
This example shows transit lines sorted by mode. Because the public transport network includes line loadings, this report includes passenger distance and passenger hours. This report shows data for all user classes. The program also produces a separate report for each user class.
If the public transport network does not include line loadings, the program only reports transit line attributes once, as the attributes are common to all user classes.
You can produce a report of transit line loadings with the LINEVOLS keyword in the REPORT control statement.
Sample of transit-line-loading report
REPORT LINEVOLS UserClass=Total
Name Mode Op
N ON OFF VOL
-------------------------------------------
ISL-DN 1 1
-----------------------
2072 7,526.20 -- 7,526.20
2070 -- 874.81 6,651.39
2068 20,072.95 1,692.68 25,031.66
2066 3,737.72 4,876.35 23,893.03
2062 7,132.78 1,290.47 29,735.34
2058 1,383.06 1,883.62 29,234.78
2056 1,817.37 13,423.42 17,628.73
2054 5,084.75 577.75 22,135.73
2052 45.97 15,108.40 7,073.30
2004 8.0 7,073.30 8.02
2001 -- 8.02 --
This example report shows the number of passengers boarding, alighting, and riding through the nodes of a transit line. This report shows only stopping nodes with some passenger activity because STOPSONLY and SKIP0 are set to T.
This report shows data for all user classes. You can request a separate report for each user class.
If the program performed crowd modeling with wait-time adjustments, the program would supplement reports showing all user classes with columns showing the flow-metered boarding, alighting, and through-ridership volumes.
When performing loading, the program automatically produces two reports showing transfers between modes:
-
A report showing transfers between all modes (that is, transit and nontransit)
-
A report showing transfers between transit modes (ignoring walk transfers between transit modes)
The program produces these reports for each user class and for all classes combined.
Sample of transfers-between-modes report
REPORT XFERSUM=MODE UserClass=1 MODE 1 7 8 11 33 34 ---------------------------------------------------------------------- 1 -- -- -- -- 35,419.40 39,796.77 7 -- 131,189.92 63,228.77 10,669.03 124,326.24 19,008.94 8 -- 58,769.06 29,930.60 5,459.60 49,723.45 17,346.75 11 -- 10,255.88 2,931.91 1,629.01 3,849.26 116.51 33 38,743.98 126,731.07 47,398.96 444.35 -- -- 34 36,472.20 21,476.97 17,739.22 580.58 -- -- MODE names: 1 = Train 7 = Bus 8 = Underground 11 = Light Rail 33 = Access/Egress 34 = Walk Xfer REPORT XFERSUM=TMODE UserClass=1 TMODE 1 7 8 11 ------------------------------------------------- 1 -- 21,476.97 17,739.22 580.58 7 19,008.94 131,189.92 63,228.77 10,669.03 8 17,346.75 58,769.06 29,930.60 5,459.60 11 116.51 10,255.88 2,931.91 1,629.01 MODE names: 1 = Train 7 = Bus 8 = Underground 11 = Light Rail 33 = Access/Egress 34 = Walk Xfer
When performing loading, the program automatically produces a report showing transfers between operators. The program produces this report for each user class and for all classes combined.
Sample of transfers-between-operators report
REPORT XFERSUM=OPERATOR UserClass=1 OPERATOR 1 11 14 19 ---------------------------------------------------- 1 -- 21,476.97 17,739.22 580.58 11 19,008.94 131,189.92 63,228.77 10,669.03 14 17,346.75 58,769.06 29,930.60 5,459.60 19 116.51 10,255.88 2,931.91 1,629.01 OPERATOR names: 1 = BR - Stratford - Lea Valley Services 11 = BR - Fenchurch Street 14 = BR - Upminster Branches 19 = BR - Liverpool Street - Via Stratford